home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3x / askillash_array.z / askillash_array
Encoding:
Text File  |  2002-10-03  |  6.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaasssskkkkiiiillllllllaaaasssshhhh____aaaarrrrrrrraaaayyyy((((3333xxxx))))                                        aaaasssskkkkiiiillllllllaaaasssshhhh____aaaarrrrrrrraaaayyyy((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      askillash_array, askillash_local, askillash_server - send a signal to an
  10.      array session
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<aaaarrrrrrrraaaayyyyssssvvvvccccssss....hhhh>>>>
  15.  
  16.      iiiinnnntttt aaaasssskkkkiiiillllllllaaaasssshhhh____aaaarrrrrrrraaaayyyy((((aaaasssssssseeeerrrrvvvveeeerrrr____tttt SSSSeeeerrrrvvvveeeerrrr,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr ****AAAArrrrrrrraaaayyyyNNNNaaaammmmeeee,,,,
  17.                          aaaasssshhhh____tttt AAAASSSSHHHH,,,, iiiinnnntttt SSSSiiiigggg))));;;;
  18.      iiiinnnntttt aaaasssskkkkiiiillllllllaaaasssshhhh____llllooooccccaaaallll((((aaaasssshhhh____tttt AAAASSSSHHHH,,,, iiiinnnntttt SSSSiiiigggg))));;;;
  19.      iiiinnnntttt aaaasssskkkkiiiillllllllaaaasssshhhh____sssseeeerrrrvvvveeeerrrr((((aaaasssssssseeeerrrrvvvveeeerrrr____tttt SSSSeeeerrrrvvvveeeerrrr,,,, aaaasssshhhh____tttt AAAASSSSHHHH,,,, iiiinnnntttt SSSSiiiigggg))));;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      The _a_s_k_i_l_l_a_s_h__a_r_r_a_y, _a_s_k_i_l_l_a_s_h__l_o_c_a_l, and _a_s_k_i_l_l_a_s_h__s_e_r_v_e_r functions all
  23.      send a signal to each of the processes that belong to the array session
  24.      specified by the array session handle AAAASSSSHHHH at the moment the function is
  25.      executed.  The signal that is to be sent is specified by SSSSiiiigggg and is
  26.      either one from the list given in _s_i_g_n_a_l(2), or 0.  If SSSSiiiigggg is 0 (the null
  27.      signal), error checking is performed but no signals are actually sent.
  28.      This can be used to check the validity of AAAASSSSHHHH.
  29.  
  30.      The real or effective user ID of the sending process must match the real,
  31.      saved, or effective user ID of the receiving processes, unless the
  32.      effective user ID of the sending process is superuser.
  33.  
  34.      For _a_s_k_i_l_l_a_s_h__a_r_r_a_y and _a_s_k_i_l_l_a_s_h__s_e_r_v_e_r, the SSSSeeeerrrrvvvveeeerrrr argument specifies
  35.      an optional array server token, which can be used to direct the request
  36.      to a specific array services daemon.  If NULL is specified instead, the
  37.      request will be processed by the default array services daemon (see
  38.      _a_r_r_a_y(1) for more information on how the default array services daemon is
  39.      selected).  For more details on creating an array server token, see
  40.      _a_s_o_p_e_n_s_e_r_v_e_r(3X).
  41.  
  42.      _a_s_k_i_l_l_a_s_h__a_r_r_a_y will send a signal to the members of the specified array
  43.      session on each of the machines in the array specified by AAAArrrrrrrraaaayyyyNNNNaaaammmmeeee, or
  44.      the default array if AAAArrrrrrrraaaayyyyNNNNaaaammmmeeee is NULL.  The operation will be
  45.      coordinated by the array services daemon specified by the server token
  46.      SSSSeeeerrrrvvvveeeerrrr.
  47.  
  48.      _a_s_k_i_l_l_a_s_h__l_o_c_a_l will only send a signal to the members of the specified
  49.      array session that are running on the same machine as the one that
  50.      executes _a_s_k_i_l_l_a_s_h__l_o_c_a_l.  Unlike _a_s_k_i_l_l_a_s_h__a_r_r_a_y and _a_s_k_i_l_l_a_s_h__s_e_r_v_e_r,
  51.      this function does not require the array services daemon (_a_r_r_a_y_d).
  52.  
  53.      _a_s_k_i_l_l_a_s_h__s_e_r_v_e_r will only send a signal to the members of the specified
  54.      array session that are running on the machine specified with the server
  55.      token SSSSeeeerrrrvvvveeeerrrr.
  56.  
  57.      All three functions will fail if one or more of the following are true:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaasssskkkkiiiillllllllaaaasssshhhh____aaaarrrrrrrraaaayyyy((((3333xxxx))))                                        aaaasssskkkkiiiillllllllaaaasssshhhh____aaaarrrrrrrraaaayyyy((((3333xxxx))))
  71.  
  72.  
  73.  
  74.      * SSSSiiiigggg is not a valid signal number
  75.  
  76.      * SSSSiiiigggg is SIGKILL and the specified array session contains process 1
  77.  
  78.      * The user ID of the sending process is not superuser, and its real or
  79.        effective user ID does not match the real, saved, or effective user ID
  80.        of the receiving processes
  81.  
  82.      * The array services daemon (_a_r_r_a_y_d) is not currently active (not
  83.        applicable for _a_s_k_i_l_l_a_s_h__l_o_c_a_l)
  84.  
  85.      If one or more of these conditions apply only to a subset of the
  86.      processes in an array session, it is undefined whether or not these
  87.      functions will complete for some or all of processes that are _n_o_t
  88.      affected.
  89.  
  90.      These functions are _n_o_t atomic with respect to process creation.  As a
  91.      result, it is possible that a new process could join the array session
  92.      after the signalling operation has started but before it has completed
  93.      and consequently never receive the signal itself.
  94.  
  95. NNNNOOOOTTTTEEEESSSS
  96.      All of these functions are found in the library "libarray.so", and will
  97.      be loaded if the option "-larray" is used with _c_c(1) or _l_d(1).
  98.  
  99. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  100.      kill(2), aserrorcode(3X), askillpid_server(3X), asopenserver(3X),
  101.      array_sessions(5).
  102.  
  103. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  104.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  105.      of -1 is returned and _a_s_e_r_r_o_r_c_o_d_e(3x) is set accordingly.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.